home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / etc / RCS / valloc.man,v < prev   
Encoding:
Text File  |  1992-04-21  |  1.4 KB  |  78 lines
  1. head     1.1;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.1
  10. date     92.04.21.14.13.40;  author kupfer;  state Exp;
  11. branches ;
  12. next     ;
  13.  
  14.  
  15. desc
  16. @Man page for valloc().
  17. @
  18.  
  19.  
  20.  
  21. 1.1
  22. log
  23. @Initial revision
  24. @
  25. text
  26. @'\" Copyright 1992 Regents of the University of California
  27. '\" Permission to use, copy, modify, and distribute this
  28. '\" documentation for any purpose and without fee is hereby
  29. '\" granted, provided that this notice appears in all copies.
  30. '\" The University of California makes no representations about
  31. '\" the suitability of this material for any purpose.  It is
  32. '\" provided "as is" without express or implied warranty.
  33. '\" 
  34. '\" $Header: /sprite/lib/forms/RCS/lib.man,v 1.4 92/03/02 15:25:36 bmiller Exp $ SPRITE (Berkeley)
  35. '/" 
  36. .so \*(]ltmac.sprite
  37. .HS valloc lib
  38. .BS
  39. '\" Note:  do not modify the .SH NAME line immediately below!
  40. .SH NAME
  41. valloc \- page-aligned memory allocator
  42. .SH SYNOPSIS
  43. .nf
  44. \fB#include <unistd.h>\fR
  45. .sp
  46. void *
  47. \fBvalloc\fR(\fIsize\fP)
  48. .SH ARGUMENTS
  49. .AS size_t size
  50. .AP size_t size in
  51. Number of bytes to allocate.
  52. .BE
  53.  
  54. .SH DESCRIPTION
  55. .PP
  56. .B valloc
  57. is like 
  58. .BR malloc ,
  59. except that the pointer it returns is guaranteed to be page-aligned.
  60.  
  61. .SH BUGS
  62. .PP
  63. Using
  64. .B free
  65. to deallocate
  66. .BR valloc 'd
  67. memory can corrupt
  68. .BR malloc .
  69. Unfortunately, there is no
  70. .B vfree
  71. routine, so it is currently impossible to free
  72. .BR valloc 'd 
  73. memory.
  74.  
  75. .SH KEYWORDS
  76. memory, alloc
  77. @
  78.